home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / peepok12.zip / PP12.DOC < prev    next >
Text File  |  1991-10-10  |  4KB  |  136 lines
  1.  
  2.  
  3.                                 PP.EXE
  4.                                 ──────
  5.  
  6.                          (Ver 1.2 - 29 Apr 91)
  7.  
  8.  
  9.                      Copyright(c) and developed by
  10.  
  11.                              José Campione
  12.       2415 SouthVale Cr. U-25, Ottawa, Ont. K1B 4T9 (613) 523-4345.
  13.  
  14.                                  and
  15.  
  16.                          C. Robert Parkinson
  17.           5 Ramsgate, Ottawa, Ont. K1V 8M4, (613) 523-7299.
  18.  
  19.  
  20.                      ... from the PUB SQUAD ...
  21.  
  22.                                *  *  *
  23.  
  24.  
  25.  NOTICE
  26.  ======
  27.  
  28.      This program and every file distributed with it are copyright (C)
  29.  by the authors, who retain authorship both of the pre-compiled and 
  30.  compiled codes.  Their use and distribution are unrestricted, as long
  31.  as nobody gets any richer in the process.  Although these programs 
  32.  were developed to the best of the authors abilities, no guarantees
  33.  can be given as to their performance.  By using them, the user
  34.  accepts all risks and the authors decline all liability. 
  35.  
  36.  
  37.  DESCRIPTION
  38.  ===========
  39.  
  40.      PP.EXE (PeekPoke) is a very simple program allowing the peeking
  41.  and poking of addresses in the computer's memory. 
  42.  
  43.      Poking effectively changes bytes in memory and this may have 
  44.  harmfull effects on the operation of your computer and software. 
  45.  However, resetting the computer will usually restore things to
  46.  normal.  As opposed to PORTS.EXE (the acommpanying program), PP does
  47.  not harm hardware.
  48.  
  49.      PP.EXE can be most useful in determining, or changing, the value
  50.  in an I/O port, the BIOS Data Area, a Disk Parameter Block, etc. 
  51.  
  52.  
  53.  CAUTION
  54.  =======
  55.  
  56.      WARNING!!!  This program can modify memory locations in your
  57.      *******     computer and, unless used with great care, may well
  58.                  crash the system.  You have been warned.
  59.  
  60.  
  61.  SYNTAX
  62.  ======
  63.  
  64.      To read the byte value ("peek"), use:
  65.  
  66.              "PP e segment:offset <!>"
  67.  
  68.      To write a byte value ("poke"), use:
  69.  
  70.              "PP o segment:offset byte_value <!>"
  71.  
  72.      Where:
  73.  
  74.            "segment:offset" is the desired memory location.  It can
  75.                             be entered as hexadecimal numbers (they 
  76.                             must be preceded by the "$" sign as in the
  77.                             example below), as decimal numbers
  78.                             (without the "$" sign), or a mixture of
  79.                             both.  Both words have to separated by the
  80.                             ":" punctuation, without any additional
  81.                             spaces or characters.
  82.  
  83.  
  84.            "byte_value" is the value of the byte that you wish
  85.                         written to that memory location.  It may be
  86.                         in decimal or hex format.  If hex, it must
  87.                         be preceded by the "$" sign (e.g., $33).
  88.  
  89.            "!" is an optional parameter that causes the memory
  90.                location, in segment:offset hex notation, and the byte
  91.                value in both decimal, hex and binary form, to be
  92.                displayed on the screen.  For a write operation, both
  93.                the old and the new values will be displayed.
  94.                 
  95.  
  96.  ERRORLEVEL
  97.  ==========
  98.  
  99.      In both read and write operations, the original ASCII decimal
  100.  byte value is returned as an exit errorlevel, which can be tested
  101.  from a batch file.
  102.  
  103.  
  104.  EXAMPLE
  105.  =======
  106.  
  107.      Hex address $0040:$0065 contains the BIOS byte with the video
  108.  card configuration.  The following examples will all display the
  109.  same byte:
  110.  
  111.          C:\>PP e $0040:$0065 !
  112.  
  113.          C:\>PP e $40:$65 !
  114.  
  115.          C:\>PP e $40:$0065 !
  116.  
  117.          C:\>PP e $0040:$65 !
  118.  
  119.          C:\>PP e 64:101 !
  120.  
  121.          C:\>PP e $40:101 !
  122.  
  123.          C:\>PP e 64:$0065 !
  124.  
  125.      The result of all these commands is always the same:
  126.  
  127.          mem[0040h:0065h] = 41d, 0029h, 00101001b.
  128.  
  129.      (although the actual value of the byte may change from system
  130.       to system).
  131.  
  132.  
  133.                                   *  *  *
  134.  
  135. 
  136.